<h2>Events Shortcode</h2>
<p>This page explains how to add Events listings and calendars to a page, post or template using a Wordpress shortcode. <strong>Shortcodes</strong> in Wordpress are used to simplify adding complex markup to pages to embed things like video, audio, scripts and image galleries. To use the events shortcode, you type the events keyword in square brackets in the content of your post/page wherever you want the events listing or calendar to appear. The shortcode can also hold additional information, or options, in a series of name/value pairs, e.g.</p>
<p><code>[events option1=&quot;value1&quot; option2=&quot;value2&quot;]</code></p>
<h3>Options</h3>
<p><strong>format</strong></p>
<p><em>optional (default &ldquo;list&rdquo;)</em> Can be one of  the following:</p>
<ul>
	<li>list &ndash; produces an unordered list of events</li>
	<li>calendar &ndash; produces a compact events calendar (only one of these is allowed on a page)</li>
	<li>fullcalendar &ndash; produces a	full-page calendar similar to a google calendar</li>
	<li>json &ndash; produces a list of	events in JSON format</li>
</ul>
<h4>List options</h4>
<p><strong>upcoming</strong></p>
<p><em>optional (default 0)</em> The number of forthcoming events to display in the list. Forthcoming events are displayed in reverse date order, with the next event at the top of the list.</p>
<p><strong>title_upcoming</strong></p>
<p><em>optional (default &quot;Upcoming Events&quot;)</em> The title to place above the list of forthcoming events</p>
<p><strong>format_upcoming</strong></p>
<p><em>optional (default &ldquo;list&quot;)</em> Can be one of the following:</p>
<ul>
	<li>list &ndash; each event is listed by the title, linked to the page for the corresponding event. If a date is included, it appears under the title (using a line break).</li>
	<li>short &ndash; each event is listed by the title (in &lt;h3&gt; tags), linked to the page for the corresponding event. If a date is included, it appears in a paragraph under the title. The excerpt for the event (if available) is also included.</li>
	<li>featured &ndash; each event has a thumbnail, followed by the title (in &lt;h3&gt; tags), linked to the page for the corresponding event. If a date is included, it appears in a paragraph under the title. The excerpt for the event (if available) is also included.</li>
	<li>long - each event has a thumbnail, followed by the title (in &lt;h3&gt; tags), linked to the page for the corresponding event. If a date is included, it appears in a paragraph under the title. The full content for the event is also included.</li>
</ul>
<p><strong>recent</strong></p>
<p><em>optional (default 0)</em> The number of recent events to show in the list. Recent events are displayed in date order, with the most recent at the top of the list.</p>
<p><strong>title_recent</strong></p>
<p><em>optional (default &quot;Recent Events&quot;)</em> The title which appears above the recent events list.</p>
<p><strong>format_recent</strong></p>
<p><em>optional (default &quot;list&quot;)</em> Can be on of the options described in format_upcoming</p>
<p><strong>thumbnail_size</strong></p>
<p><em>optional (default &quot;thumbnail&quot;)</em> The size of the thumbnail used in the . Can either be a named image size (thumbnail, medium, post-thumbnail, large, or a custom size) or a pair of numbers, comma separated, denoting the pixel size of the thumbnail required.</p>
<p><strong>max</strong></p>
<p><em>optional (default 10)</em> The maximum number of Events to display. This will override the recent and
upcoming options if they add up to a greater number. Examples:</p>
<ul>
	<li>if you set max to 6, upcoming to 4 and recent to 4, you will get 4 upcoming and 2 recent events in the list (upcoming events take precedence)</li>
	<li>if you set max to 6, upcoming to 4 and recent to 6, but you only have one upcoming event, the result will be one upcoming and 5 recent events in the list.</li>
</ul>
<p><strong>category</strong></p>
<p><em>optional (default false)</em> Whether to filter the list by category. Use category IDs separated by commas.</p>
<p><strong>before_title</strong></p>
<p><em>optional (default &quot;&lt;h3&gt;&quot;)</em> Text/HTML to place before each title</p>
<p><strong>after_title</strong></p>
<p><em>optional (default &quot;&lt;/h3&gt;&quot;)</em> Text/HTML to place after each title</p>
<h4>Date display options</h4>
<p><strong>display_dates</strong></p>
<p><em>optional (default true)</em> Whether to display dates or not in the list</p>
<p><strong>date_fmt</strong></p>
<p><em>optional (default &quot;j/n/Y&quot;)</em>Format for dates &ndash; see <a href="http://www.php.net/manual/en/function.date.php">http://www.php.net/manual/en/function.date.php</a> for details.</p>
<p><strong>time_fmt</strong></p>
<p><em>optional (default &quot;g.ia&quot;)</em> Format for times &ndash; see <a href="http://www.php.net/manual/en/function.date.php">http://www.php.net/manual/en/function.date.php</a> for details.</p>
<p><strong>date_time_separator</strong></p>
<p><em>optional (default &quot; | &quot;)</em> Separator used for date and time.</p>
<p><strong>time_separator</strong></p>
<p><em>optional (default &quot; &amp;mdash; &quot;)</em> Separator for times, used when an event takes place between two times on the same day.</p>
<p><strong>date_separator</strong></p>
<p><em>optional (default &quot; &amp;mdash; &quot;)</em> Separator for dates, when an event takes place over a number of days.</p>
<p><strong>allday</strong></p>
<p><em>optional (default &quot; (all day)&quot;)</em> Text to append to event dates if they take place all day.</p>
<p><strong>date_label</strong></p>
<p><em>optional (default &quot;Date: &quot;)</em> Label used for dates.</p>
<p><strong>time_label</strong></p>
<p><em>optional (default &quot;Time: &quot;)</em> Label used for times.</p>
<h4>CSS classes used in the output</h4>
<p>Each list has the class <code>events-listing</code>, with the recent events list having the additional <code>recent-events</code> class.</p>
<p>Dates are wrapped in spans with the following classes:</p>
<p><code>event-date-label</code><br />
<code>event-time-label</code><br />
<code>event-start-date</code><br />
<code>event-start-time</code><br />
<code>event-end-date</code><br />
<code>event-end-time</code></p>
